<?php

/**
 * @package dompdf
 * @link    http://www.dompdf.com/
 * @author  Benj Carson <benjcarson@digitaljunkies.ca>
 * @author  Fabien M�nager <fabien.menager@gmail.com>
 * @license http://www.gnu.org/copyleft/lesser.html GNU Lesser General Public License
 * @version $Id: dompdf.cls.php 468 2012-02-05 10:51:40Z fabien.menager $
 */

/**
 * DOMPDF - PHP5 HTML to PDF renderer
 *
 * DOMPDF loads HTML and does its best to render it as a PDF.  It gets its
 * name from the new DomDocument PHP5 extension.  Source HTML is first
 * parsed by a DomDocument object.  DOMPDF takes the resulting DOM tree and
 * attaches a {@link Frame} object to each node.  {@link Frame} objects store
 * positioning and layout information and each has a reference to a {@link
 * Style} object.
 *
 * Style information is loaded and parsed (see {@link Stylesheet}) and is
 * applied to the frames in the tree by using XPath.  CSS selectors are
 * converted into XPath queries, and the computed {@link Style} objects are
 * applied to the {@link Frame}s.
 *
 * {@link Frame}s are then decorated (in the design pattern sense of the
 * word) based on their CSS display property ({@link
 * http://www.w3.org/TR/CSS21/visuren.html#propdef-display}).
 * Frame_Decorators augment the basic {@link Frame} class by adding
 * additional properties and methods specific to the particular type of
 * {@link Frame}.  For example, in the CSS layout model, block frames
 * (display: block;) contain line boxes that are usually filled with text or
 * other inline frames.  The Block_Frame_Decorator therefore adds a $lines
 * property as well as methods to add {@link Frame}s to lines and to add
 * additional lines.  {@link Frame}s also are attached to specific
 * Positioner and {@link Frame_Reflower} objects that contain the
 * positioining and layout algorithm for a specific type of frame,
 * respectively.  This is an application of the Strategy pattern.
 *
 * Layout, or reflow, proceeds recursively (post-order) starting at the root
 * of the document.  Space constraints (containing block width & height) are
 * pushed down, and resolved positions and sizes bubble up.  Thus, every
 * {@link Frame} in the document tree is traversed once (except for tables
 * which use a two-pass layout algorithm).  If you are interested in the
 * details, see the reflow() method of the Reflower classes.
 *
 * Rendering is relatively straightforward once layout is complete. {@link
 * Frame}s are rendered using an adapted {@link Cpdf} class, originally
 * written by Wayne Munro, http://www.ros.co.nz/pdf/.  (Some performance
 * related changes have been made to the original {@link Cpdf} class, and
 * the {@link CPDF_Adapter} class provides a simple, stateless interface to
 * PDF generation.)  PDFLib support has now also been added, via the {@link
 * PDFLib_Adapter}.
 *
 *
 * @package dompdf
 */
class DOMPDF {

    /**
     * DomDocument representing the HTML document
     *
     * @var DomDocument
     */
    protected $_xml;

    /**
     * Frame_Tree derived from the DOM tree
     *
     * @var Frame_Tree
     */
    protected $_tree;

    /**
     * Stylesheet for the document
     *
     * @var Stylesheet
     */
    protected $_css;

    /**
     * Actual PDF renderer
     *
     * @var Canvas
     */
    protected $_pdf;

    /**
     * Desired paper size ('letter', 'legal', 'A4', etc.)
     *
     * @var string
     */
    protected $_paper_size;

    /**
     * Paper orientation ('portrait' or 'landscape')
     *
     * @var string
     */
    protected $_paper_orientation;

    /**
     * Callbacks on new page and new element
     *
     * @var array
     */
    protected $_callbacks;

    /**
     * Experimental caching capability
     *
     * @var string
     */
    private $_cache_id;

    /**
     * Base hostname
     *
     * Used for relative paths/urls
     * @var string
     */
    protected $_base_host;

    /**
     * Absolute base path
     *
     * Used for relative paths/urls
     * @var string
     */
    protected $_base_path;

    /**
     * Protcol used to request file (file://, http://, etc)
     *
     * @var string
     */
    protected $_protocol;

    /**
     * HTTP context created with stream_context_create()
     * Will be used for file_get_contents
     *
     * @var resource 
     */
    protected $_http_context;

    /**
     * Timestamp of the script start time
     * 
     * @var int 
     */
    private $_start_time = null;

    /**
     * @var string The system's locale
     */
    private $_system_locale = null;

    /**
     * @var bool Tells if the system's locale is the C standard one
     */
    private $_locale_standard = false;

    /**
     * @var string The default view of the PDF in the viewer
     */
    private $_default_view = "Fit";

    /**
     * @var array The default view options of the PDF in the viewer
     */
    private $_default_view_options = array();

    /**
     * @var bool Tells wether the DOM document is in quirksmode (experimental)
     */
    private $_quirksmode = false;
    public static $native_fonts = array("courier", "courier-bold", "courier-oblique", "courier-boldoblique",
        "helvetica", "helvetica-bold", "helvetica-oblique", "helvetica-boldoblique",
        "times-roman", "times-bold", "times-italic", "times-bolditalic",
        "symbol", "zapfdinbats");

    /**
     * Class constructor
     */
    function __construct() {
        $this->_locale_standard = sprintf('%.1f', 1.0) == '1.0';

        $this->save_locale();

        $this->_messages = array();
        $this->_css = new Stylesheet($this);
        $this->_pdf = null;
        $this->_paper_size = "letter";
        $this->_paper_orientation = "portrait";
        $this->_base_protocol = "";
        $this->_base_host = "";
        $this->_base_path = "";
        $this->_http_context = null;
        $this->_callbacks = array();
        $this->_cache_id = null;

        $this->restore_locale();
    }

    /**
     * Class destructor
     */
    function __destruct() {
        clear_object($this);
    }

    /**
     * Save the system's locale configuration and 
     * set the right value for numeric formatting
     */
    private function save_locale() {
        if ($this->_locale_standard)
            return;

        $this->_system_locale = setlocale(LC_NUMERIC, "C");
    }

    /**
     * Restore the system's locale configuration
     */
    private function restore_locale() {
        if ($this->_locale_standard)
            return;

        setlocale(LC_NUMERIC, $this->_system_locale);
    }

    /**
     * Returns the underlying {@link Frame_Tree} object
     *
     * @return Frame_Tree
     */
    function get_tree() {
        return $this->_tree;
    }

    /**
     * Sets the protocol to use
     * FIXME validate these
     * 
     * @param string $proto
     */
    function set_protocol($proto) {
        $this->_protocol = $proto;
    }

    /**
     * Sets the base hostname
     *
     * @param string $host
     */
    function set_host($host) {
        $this->_base_host = $host;
    }

    /**
     * Sets the base path
     *
     * @param string $path
     */
    function set_base_path($path) {
        $this->_base_path = $path;
    }

    /**
     * Sets the HTTP context
     *
     * @param resource $http_context
     */
    function set_http_context($http_context) {
        $this->_http_context = $http_context;
    }

    /**
     * Sets the default view
     *
     * @param string $default_view
     */
    function set_default_view($default_view, $options) {
        $this->_default_view = $default_view;
        $this->_default_view_options = $options;
    }

    /**
     * Returns the protocol in use
     *
     * @return string
     */
    function get_protocol() {
        return $this->_protocol;
    }

    /**
     * Returns the base hostname
     *
     * @return string
     */
    function get_host() {
        return $this->_base_host;
    }

    /**
     * Returns the base path
     *
     * @return string
     */
    function get_base_path() {
        return $this->_base_path;
    }

    /**
     * Returns the HTTP context
     *
     * @return resource
     */
    function get_http_context() {
        return $this->_http_context;
    }

    /**
     * Return the underlying Canvas instance (e.g. CPDF_Adapter, GD_Adapter)
     *
     * @return Canvas
     */
    function get_canvas() {
        return $this->_pdf;
    }

    /**
     * Returns the callbacks array
     *
     * @return array
     */
    function get_callbacks() {
        return $this->_callbacks;
    }

    /**
     * Returns the stylesheet
     *
     * @return Stylesheet
     */
    function get_css() {
        return $this->_css;
    }

    /**
     * Loads an HTML file
     *
     * Parse errors are stored in the global array _dompdf_warnings.
     *
     * @param string $file a filename or url to load
     */
    function load_html_file($file) {
        $this->save_locale();

        // Store parsing warnings as messages (this is to prevent output to the
        // browser if the html is ugly and the dom extension complains,
        // preventing the pdf from being streamed.)
        if (!$this->_protocol && !$this->_base_host && !$this->_base_path)
            list($this->_protocol, $this->_base_host, $this->_base_path) = explode_url($file);

        if (!DOMPDF_ENABLE_REMOTE &&
                ($this->_protocol != "" && $this->_protocol !== "file://" ))
            throw new DOMPDF_Exception("Remote file requested, but DOMPDF_ENABLE_REMOTE is false.");

        if ($this->_protocol == "" || $this->_protocol === "file://") {

            $realfile = realpath($file);
            if (!$file)
                throw new DOMPDF_Exception("File '$file' not found.");

            if (strpos($realfile, DOMPDF_CHROOT) !== 0)
                throw new DOMPDF_Exception("Permission denied on $file.");

            // Exclude dot files (e.g. .htaccess)
            if (substr(basename($realfile), 0, 1) === ".")
                throw new DOMPDF_Exception("Permission denied on $file.");

            $file = $realfile;
        }

        $contents = file_get_contents($file, null, $this->_http_context);
        $encoding = null;

        // See http://the-stickman.com/web-development/php/getting-http-response-headers-when-using-file_get_contents/
        if (isset($http_response_header)) {
            foreach ($http_response_header as $_header) {
                if (preg_match("@Content-Type:\s*[\w/]+;\s*?charset=([^\s]+)@i", $_header, $matches)) {
                    $encoding = strtoupper($matches[1]);
                    break;
                }
            }
        }

        $this->restore_locale();

        $this->load_html($contents, $encoding);
    }

    /**
     * Loads an HTML string
     *
     * Parse errors are stored in the global array _dompdf_warnings.
     *
     * @todo use the $encoding variable
     * @param string $str HTML text to load
     */
    function load_html($str, $encoding = null) {
        $this->save_locale();

        // FIXME: Determine character encoding, switch to UTF8, update meta tag. Need better http/file stream encoding detection, currently relies on text or meta tag.
        mb_detect_order('auto');

        if (mb_detect_encoding($str) !== 'UTF-8') {
            $metatags = array(
                '@<meta\s+http-equiv="Content-Type"\s+content="(?:[\w/]+)(?:;\s*?charset=([^\s"]+))?@i',
                '@<meta\s+content="(?:[\w/]+)(?:;\s*?charset=([^\s"]+))"?\s+http-equiv="Content-Type"@i',
                '@<meta [^>]*charset\s*=\s*["\']?\s*([^"\' ]+)@i',
            );

            foreach ($metatags as $metatag) {
                if (preg_match($metatag, $str, $matches))
                    break;
            }

            if (mb_detect_encoding($str) == '') {
                if (isset($matches[1])) {
                    $encoding = strtoupper($matches[1]);
                } else {
                    $encoding = 'UTF-8';
                }
            } else {
                if (isset($matches[1])) {
                    $encoding = strtoupper($matches[1]);
                } else {
                    $encoding = 'auto';
                }
            }

            if ($encoding !== 'UTF-8') {
                $str = mb_convert_encoding($str, 'UTF-8', $encoding);
            }

            if (isset($matches[1])) {
                $str = preg_replace('/charset=([^\s"]+)/i', 'charset=UTF-8', $str);
            } else {
                $str = str_replace('<head>', '<head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">', $str);
            }
        } else {
            $encoding = 'UTF-8';
        }

        // remove BOM mark from UTF-8, it's treated as document text by DOMDocument
        // FIXME: roll this into the encoding detection using UTF-8/16/32 BOM (http://us2.php.net/manual/en/function.mb-detect-encoding.php#91051)?
        if (substr($str, 0, 3) == chr(0xEF) . chr(0xBB) . chr(0xBF)) {
            $str = substr($str, 3);
        }

        // Parse embedded php, first-pass
        if (DOMPDF_ENABLE_PHP) {
            ob_start();
            eval("?" . ">$str");
            $str = ob_get_clean();
        }

        // if the document contains non utf-8 with a utf-8 meta tag chars and was 
        // detected as utf-8 by mbstring, problems could happen.
        // http://devzone.zend.com/article/8855
        if ($encoding !== 'UTF-8') {
            $re = '/<meta ([^>]*)((?:charset=[^"\' ]+)([^>]*)|(?:charset=["\'][^"\' ]+["\']))([^>]*)>/i';
            $str = preg_replace($re, '<meta $1$3>', $str);
        }

        // Store parsing warnings as messages
        set_error_handler("record_warnings");

        // @todo Take the quirksmode into account
        // http://hsivonen.iki.fi/doctype/
        // https://developer.mozilla.org/en/mozilla's_quirks_mode
        $quirksmode = false;

        if (DOMPDF_ENABLE_HTML5PARSER) {
            $tokenizer = new HTML5_Tokenizer($str);
            $tokenizer->parse();
            $doc = $tokenizer->save();

            // Remove #text children nodes in nodes that shouldn't have
            $tag_names = array("html", "table", "tbody", "thead", "tfoot", "tr");
            foreach ($tag_names as $tag_name) {
                $nodes = $doc->getElementsByTagName($tag_name);

                foreach ($nodes as $node) {
                    self::remove_text_nodes($node);
                }
            }

            $quirksmode = ($tokenizer->getTree()->getQuirksMode() > HTML5_TreeBuilder::NO_QUIRKS);
        } else {
            $doc = new DOMDocument();
            $doc->preserveWhiteSpace = true;
            $doc->loadHTML($str);

            // If some text is before the doctype of before the <html> tag, we are in quirksmode
            if (preg_match("/^(.+)<(!doctype|html)/i", ltrim($str), $matches)) {
                $quirksmode = true;
            } else {
                // HTML5 <!DOCTYPE html>
                if (!$doc->doctype->publicId && !$doc->doctype->systemId) {
                    $quirksmode = false;
                }

                // not XHTML
                if (!preg_match("/xhtml/i", $doc->doctype->publicId)) {
                    $quirksmode = true;
                }
            }
        }

        $this->_xml = $doc;
        $this->_quirksmode = $quirksmode;

        $this->_tree = new Frame_Tree($this->_xml);

        restore_error_handler();

        $this->restore_locale();
    }

    static function remove_text_nodes(DOMNode $node) {
        $children = array();
        for ($i = 0; $i < $node->childNodes->length; $i++) {
            $child = $node->childNodes->item($i);
            if ($child->nodeName === "#text") {
                $children[] = $child;
            }
        }

        foreach ($children as $child) {
            $node->removeChild($child);
        }
    }

    /**
     * Builds the {@link Frame_Tree}, loads any CSS and applies the styles to
     * the {@link Frame_Tree}
     */
    protected function _process_html() {
        $this->save_locale();

        $this->_tree->build_tree();

        $this->_css->load_css_file(Stylesheet::DEFAULT_STYLESHEET, Stylesheet::ORIG_UA);

        $acceptedmedia = Stylesheet::$ACCEPTED_GENERIC_MEDIA_TYPES;
        if (defined("DOMPDF_DEFAULT_MEDIA_TYPE")) {
            $acceptedmedia[] = DOMPDF_DEFAULT_MEDIA_TYPE;
        } else {
            $acceptedmedia[] = Stylesheet::$ACCEPTED_DEFAULT_MEDIA_TYPE;
        }

        // load <link rel="STYLESHEET" ... /> tags
        $links = $this->_xml->getElementsByTagName("link");
        foreach ($links as $link) {
            if (mb_strtolower($link->getAttribute("rel")) === "stylesheet" ||
                    mb_strtolower($link->getAttribute("type")) === "text/css") {
                //Check if the css file is for an accepted media type
                //media not given then always valid
                $formedialist = preg_split("/[\s\n,]/", $link->getAttribute("media"), -1, PREG_SPLIT_NO_EMPTY);
                if (count($formedialist) > 0) {
                    $accept = false;
                    foreach ($formedialist as $type) {
                        if (in_array(mb_strtolower(trim($type)), $acceptedmedia)) {
                            $accept = true;
                            break;
                        }
                    }
                    if (!$accept) {
                        //found at least one mediatype, but none of the accepted ones
                        //Skip this css file.
                        continue;
                    }
                }

                $url = $link->getAttribute("href");
                $url = build_url($this->_protocol, $this->_base_host, $this->_base_path, $url);

                $this->_css->load_css_file($url, Stylesheet::ORIG_AUTHOR);
            }
        }

        // Set the base path of the Stylesheet to that of the file being processed
        $this->_css->set_protocol($this->_protocol);
        $this->_css->set_host($this->_base_host);
        $this->_css->set_base_path($this->_base_path);

        // load <style> tags
        $styles = $this->_xml->getElementsByTagName("style");
        foreach ($styles as $style) {

            // Accept all <style> tags by default (note this is contrary to W3C
            // HTML 4.0 spec:
            // http://www.w3.org/TR/REC-html40/present/styles.html#adef-media
            // which states that the default media type is 'screen'
            if ($style->hasAttributes() &&
                    ($media = $style->getAttribute("media")) &&
                    !in_array($media, $acceptedmedia))
                continue;

            $css = "";
            if ($style->hasChildNodes()) {

                $child = $style->firstChild;
                while ($child) {
                    $css .= $child->nodeValue; // Handle <style><!-- blah --></style>
                    $child = $child->nextSibling;
                }
            } else
                $css = $style->nodeValue;

            $this->_css->load_css($css);
        }

        $this->restore_locale();
    }

    /**
     * Sets the paper size & orientation
     *
     * @param string $size 'letter', 'legal', 'A4', etc. {@link CPDF_Adapter::$PAPER_SIZES}
     * @param string $orientation 'portrait' or 'landscape'
     */
    function set_paper($size, $orientation = "portrait") {
        $this->_paper_size = $size;
        $this->_paper_orientation = $orientation;
    }

    /**
     * Enable experimental caching capability
     * @access private
     */
    function enable_caching($cache_id) {
        $this->_cache_id = $cache_id;
    }

    /**
     * Sets callbacks for events like rendering of pages and elements.
     * The callbacks array contains arrays with 'event' set to 'begin_page',
     * 'end_page', 'begin_frame', or 'end_frame' and 'f' set to a function or
     * object plus method to be called.
     *
     * The function 'f' must take an array as argument, which contains info
     * about the event.
     *
     * @param array $callbacks the set of callbacks to set
     */
    function set_callbacks($callbacks) {
        if (is_array($callbacks)) {
            $this->_callbacks = array();
            foreach ($callbacks as $c) {
                if (is_array($c) && isset($c['event']) && isset($c['f'])) {
                    $event = $c['event'];
                    $f = $c['f'];
                    if (is_callable($f) && is_string($event)) {
                        $this->_callbacks[$event][] = $f;
                    }
                }
            }
        }
    }

    /**
     * Get the quirks mode
     * 
     * @return boolean true if quirks mode is active
     */
    function get_quirksmode() {
        return $this->_quirksmode;
    }

    function parse_default_view($value) {
        $valid = array("XYZ", "Fit", "FitH", "FitV", "FitR", "FitB", "FitBH", "FitBV");

        $options = preg_split("/\s*,\s*/", trim($value));
        $default_view = array_shift($options);

        if (!in_array($default_view, $valid)) {
            return false;
        }

        $this->set_default_view($default_view, $options);
        return true;
    }

    /**
     * Renders the HTML to PDF
     */
    function render() {
        $this->save_locale();

        if (DOMPDF_LOG_OUTPUT_FILE) {
            if (!file_exists(DOMPDF_LOG_OUTPUT_FILE) && is_writable(dirname(DOMPDF_LOG_OUTPUT_FILE))) {
                touch(DOMPDF_LOG_OUTPUT_FILE);
            }

            $this->_start_time = microtime(true);
            ob_start();
        }

        //enable_mem_profile();

        $this->_process_html();

        $this->_css->apply_styles($this->_tree);

        // @page style rules : size, margins
        $page_styles = $this->_css->get_page_styles();

        $base_page_style = $page_styles["base"];
        unset($page_styles["base"]);

        foreach ($page_styles as $_page_style) {
            $_page_style->inherit($base_page_style);
        }

        if (is_array($base_page_style->size)) {
            $this->set_paper(array(0, 0, $base_page_style->size[0], $base_page_style->size[1]));
        }

        $this->_pdf = Canvas_Factory::get_instance($this->_paper_size, $this->_paper_orientation);
        Font_Metrics::init($this->_pdf);

        if (DOMPDF_ENABLE_FONTSUBSETTING && $this->_pdf instanceof CPDF_Adapter) {
            foreach ($this->_tree->get_frames() as $frame) {
                $style = $frame->get_style();
                $node = $frame->get_node();

                // Handle text nodes
                if ($node->nodeName === "#text") {
                    $this->_pdf->register_string_subset($style->font_family, $node->nodeValue);
                    continue;
                }

                // Handle generated content (list items)
                if ($style->display === "list-item") {
                    $chars = List_Bullet_Renderer::get_counter_chars($style->list_style_type);
                    $this->_pdf->register_string_subset($style->font_family, $chars);
                    continue;
                }

                // TODO Handle other generated content (pseudo elements)
            }
        }

        $root = null;

        foreach ($this->_tree->get_frames() as $frame) {
            // Set up the root frame
            if (is_null($root)) {
                $root = Frame_Factory::decorate_root($this->_tree->get_root(), $this);
                continue;
            }

            // Create the appropriate decorators, reflowers & positioners.
            $deco = Frame_Factory::decorate_frame($frame, $this);
            $deco->set_root($root);

            // FIXME: handle generated content
            if ($frame->get_style()->display === "list-item") {
                // Insert a list-bullet frame
                $node = $this->_xml->createElement("bullet"); // arbitrary choice
                $b_f = new Frame($node);

                $parent_node = $frame->get_parent()->get_node();

                if (!$parent_node->hasAttribute("dompdf-children-count")) {
                    $xpath = new DOMXPath($this->_xml);
                    $count = $xpath->query("li", $parent_node)->length;
                    $parent_node->setAttribute("dompdf-children-count", $count);
                }

                if (!$parent_node->hasAttribute("dompdf-counter")) {
                    $index = ($parent_node->hasAttribute("start") ? $parent_node->getAttribute("start") - 1 : 0);
                } else {
                    $index = $parent_node->getAttribute("dompdf-counter");
                }

                $index++;
                $parent_node->setAttribute("dompdf-counter", $index);

                $node->setAttribute("dompdf-counter", $index);
                $style = $this->_css->create_style();
                $style->display = "-dompdf-list-bullet";
                $style->inherit($frame->get_style());
                $b_f->set_style($style);

                $deco->prepend_child(Frame_Factory::decorate_frame($b_f, $this));
            }
        }

        // Add meta information
        $title = $this->_xml->getElementsByTagName("title");
        if ($title->length) {
            $this->_pdf->add_info("Title", trim($title->item(0)->nodeValue));
        }

        $metas = $this->_xml->getElementsByTagName("meta");
        $labels = array(
            "author" => "Author",
            "keywords" => "Keywords",
            "description" => "Subject",
        );
        foreach ($metas as $meta) {
            $name = mb_strtolower($meta->getAttribute("name"));
            $value = trim($meta->getAttribute("content"));

            if (isset($labels[$name])) {
                $this->_pdf->add_info($labels[$name], $value);
                continue;
            }

            if ($name === "dompdf.view" && $this->parse_default_view($value)) {
                $this->_pdf->set_default_view($this->_default_view, $this->_default_view_options);
            }
        }

        $root->set_containing_block(0, 0, $this->_pdf->get_width(), $this->_pdf->get_height());
        $root->set_renderer(new Renderer($this));

        // This is where the magic happens:
        $root->reflow();

        // Clean up cached images
        Image_Cache::clear();

        global $_dompdf_warnings, $_dompdf_show_warnings;
        if ($_dompdf_show_warnings) {
            echo '<b>DOMPDF Warnings</b><br><pre>';
            foreach ($_dompdf_warnings as $msg)
                echo $msg . "\n";
            echo $this->get_canvas()->get_cpdf()->messages;
            echo '</pre>';
            flush();
        }

        $this->restore_locale();
    }

    /**
     * Add meta information to the PDF after rendering
     */
    function add_info($label, $value) {
        if (!is_null($this->_pdf))
            $this->_pdf->add_info($label, $value);
    }

    /**
     * Writes the output buffer in the log file
     * @return void
     */
    private function write_log() {
        if (!DOMPDF_LOG_OUTPUT_FILE || !is_writable(DOMPDF_LOG_OUTPUT_FILE))
            return;

        $frames = Frame::$ID_COUNTER;
        $memory = DOMPDF_memory_usage();
        $memory = number_format($memory / 1024);
        $time = number_format((microtime(true) - $this->_start_time) * 1000, 2);

        $out = "<span style='color: #000'>{$frames} frames</span>\t" .
                "<span style='color: #900'>{$memory} KB</span>\t" .
                "<span style='color: #090'>{$time} ms</span>\t" .
                "<span style='color: #009' title='Quirksmode'>" .
                ($this->_quirksmode ? "<span style='color: #c00'>ON</span>" : "<span style='color: #0c0'>OFF</span>") .
                "</span><br />";

        $out .= ob_get_clean();
        file_put_contents(DOMPDF_LOG_OUTPUT_FILE, $out);
    }

    /**
     * Streams the PDF to the client
     *
     * The file will open a download dialog by default.  The options
     * parameter controls the output.  Accepted options are:
     *
     * 'Accept-Ranges' => 1 or 0 - if this is not set to 1, then this
     *    header is not included, off by default this header seems to
     *    have caused some problems despite the fact that it is supposed
     *    to solve them, so I am leaving it off by default.
     *
     * 'compress' = > 1 or 0 - apply content stream compression, this is
     *    on (1) by default
     *
     * 'Attachment' => 1 or 0 - if 1, force the browser to open a
     *    download dialog, on (1) by default
     *
     * @param string $filename the name of the streamed file
     * @param array  $options header options (see above)
     */
    function stream($filename, $options = null) {
        $this->save_locale();

        $this->write_log();

        if (!is_null($this->_pdf))
            $this->_pdf->stream($filename, $options);

        $this->restore_locale();
    }

    /**
     * Returns the PDF as a string
     *
     * The file will open a download dialog by default.  The options
     * parameter controls the output.  Accepted options are:
     *
     *
     * 'compress' = > 1 or 0 - apply content stream compression, this is
     *    on (1) by default
     *
     *
     * @param array  $options options (see above)
     * @return string
     */
    function output($options = null) {
        $this->save_locale();

        $this->write_log();

        if (is_null($this->_pdf))
            return null;

        $output = $this->_pdf->output($options);

        $this->restore_locale();

        return $output;
    }

    /**
     * Returns the underlying HTML document as a string
     *
     * @return string
     */
    function output_html() {
        return $this->_xml->saveHTML();
    }

}
